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1,0 ABSTRACT 

The CI Exerciser is an online tool used to detect errors within a CI 
cluster and isolate a Droblem to a specific node. The software package 
consists of a user mode diagnostic that runs under the diagnostic 
supervisor, a controller class driver, and a responder class driver, 

when running the exerciser in a cluster, at least one node must be a 
controller? any or all of the nodes can be responders. The controller 
sends commands to the responder, the responder taxes the specified action 
and returns responses to the controller. In this manner, the controller can 
systematically check out the cluster and isolate any problems to a specific 
node. 

All error printouts are made at the controlling node(s); there is no 
user interface to the responder. 



2.0 PREPARING TO RUN THE CI EXERCISER 

2.1 Process Quotas And Privileges 

when running the CI Exerciser, the user must have specific privileges and 
quotas. The reauired values can be given to an account by running the 
authorize program. The privileges and quotas must at least meet the minimum 
shown in apDendix B. 



2,2 System Resources 

The SYSGEN utility can be used to modify the parameters specified below. 
Since most are non-dynamic, the system must be REBOOTED before the new 
parameters values take effect. 

IT IS STRONGLY RECOMMENDED THAT THE SYSTEM MANAGER BE NOTIFIED BEFORE 
MODIFYING THE SYSGEN PARAMETERS AND REBOOTING THE SYSTEM, 



2.3 Modifying The System Parameters 

The CI Exerciser Cand associated drivers) reauire a certain amount of system 
resources. Specifically, the values for nonpaqed pool, IRP count, SRP 
count, LRP count, scsconncnt and scsbuffcnt should be increased before 
loading and running the exerciser. Appendix A shows how to calculate tne 
- required values. The CIEPARAMS command file will modify these values for 
you. DO NOT RUN THIS COMMAND FILE WITHOUT FIRST NOTIFYING THE SYSTEM 
manager. There is a second command file that can be run to put these sysgen 
values back to the values prior to running the CIEPARAMS command file, it is 
called CIEPARRST. If CIEPARAMS is run more than once, CIEPARRST will only 
return the values to the last set. Remember that once the sysgen parameters 
are changed, rebooting will not restore them to there original values. If 
CIEPARAMS is run twice without runnino CIEPARST, the values must be changed 
manually. Refer to appendix A to calculate the amount by which CIEPARAMS 
will change the sysgen parameters and for instructions to execute the 
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command files, CIEPARAWS and CIEPARST command files are ' put Into the 
sysmaint area by the installation proceedure explained below. 

The cluster configuration is important in modifying tnese parameters. 
Controller/Respondtr nodes require greater increases to the parameters than 
Responder nodes, and larger clusters require qreater increases to the 
parameters than small clusters. 

Refer to appendix A for a table that shows the additions that should be 
made to the. system parameters as a function of node type and cluster 
configuration. 



2.4 SCS System ID 

Each node in the CI cluster must have a unique, NON-ZERQ SCS system 

identification. This parameter is strictly a software entity used by the CI 

software to distinguish between nodes in the cluster, and should not be 

confused with the system configuration register. The SCS System ID Is 

modified by the sysgen parameter SCSSYSTEMID. If more than one node in a 
cluster has the same SCS system ID, the diagnostic win NOT run correctly. 



2.5 Polling Interval 

The Interval at which the CI port driver polls should be kept at 15 seconds 
or less. This restriction helos avoid excessively long timeout intervals 
which can occur if an error is detected by the exerciser. The polling 
Interval Is controlled by the sysgen parameter PAPOLLINTERVAL. 



3.0 INSTALLING THE CI EXERCISER SOFTWARE 

The CI Exerciser software resides on floppy disk (AS-T6 37A-TE) for a 
CI780 or on TU58 C BE-T645 A-DE ) for a CI750. Installing the software simply 
Involves executing a command procedure on the media which copies the 
aoproprlate files into the SYS$mainten ance area. To Install the CI 
exerciser software on a VAX do the following: 

Log into the field service or system manager account 

Remove the console media from the console device 

Insert the CI Exerciser media into the console device 

- Mount the CI Exerciser media by typing "MOUNT CS1 CIE" 

Note: 

If the attempt to mount the CIE media falls due to no device, then 
the console must be connected using sysgen. Type the following and 
then continue the Installation: 



3 MCR SYSGEN 

SYSGEN> CONNECT CONSOLE 
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SYSGEN> EXIT 



- Perform the installation by tyoinq "3CS1 : CCIE] CIEINSTAL" 

- Dismount the CI Exerciser media by typing "dismount CS1" 

Remove the CI Exerciser media from the console device 

Replace the console media in the console device 

The latest version of the Diagnostic Supervisor should also be put into the 
sysmalnt area and used to run EVXCI, Diagnostic supervisor media is 
included in the installation kit* 



4.0 LOADING THE CI EXERCISER SOFTWARE 

Before running the CI exerciser, a second command procedure must be 
executed to load the appropriate class driver(s) into nonpaged pool. This 
procedure, CTELOAD.COM, prompts the user as to whether the node is to be a 
controller or Just a responder, and loads the driverCs) appropriately. 
Running the controller in a node will cause moderate degradation of system 
performance, while running just the responder will have less of a degradina 
effect • 

The drivers must be loaded each time the system is rebooted. To load 
the drivers, Derform the following steps: 

Log into the field service or system manager account 

- Establish cmkrnl privilege by typing "SET PROC/PRIV=CMKR rt (Not 
necessary if the system manager account is being used) 

- Load the software by typing n eSYS$MAINTENANCE;CIELOAD" 
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5.0 RUNNING THE CI EXERCISER 

Once the CI class drivers have been loaded on the system, the responder 
is ready to participate in cluster test activity. The following additional 
commands must be issued to run the controller software. Note that an ATTACH 
and SELECT command must be issued for each port that is to be tested. 

For a CI780... 

S RUN ESSAA 
DS> LOAD EVXCI 

DS> ATT CI780 SBI PAAO tr br port. number 

DS> ATT CI-NODE PAAO node-name VAX780 port-number 

DS> attach additional ports. .. 

DS> SELECT PAAO 

DS> select additional ports... 
DS> ST 



For a CI750.,. 

S RUN ECS A A 
DS> LOAD EVXCI 

DS> ATT CI750 HUB PAAO slot br port-number 

DS> ATT CI-NODE PAAO node-name VAX750 port-number 

DS> attach additional ports... 

DS> SELECT PAAO 

DS> select additional ports... 
DS> ST 

Note! 

If running the generate activity test, test 20, control C may take up to 30 
seconds to respond, when the DS promDt is returned, the desired action may 
be taken. 

Note : 

Only one controller should run either the generate activity test (test 20) 
or the monitor performance counters test (test 21) in a cluster at one time. 

A helD facility is also available with the CI Exerciser. Type "HELP 
EVXCI" to find the topics for which help information is available, and "HELP 
EVXCI topic" for information about a particular topic. 
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Below are two table, the first for nodes that are to be controllers 
and resoonders and the other for nodes that are to be only responders. 
A controller node must be a responder. The values are calculated by 
first determining the maximum number of controllers and responders 
that will be running in the system. Then plug in the values and 
determine the amount to increase the parameter. 

C = maximum number of controllers in the cluster. 

R = maximum number of resoonders in the cluster. 

add 

* multiply 
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Parameter Value to add to existing parameter 



NPAGEDYN | 


29k 






( 


2.5k 


* 


r 


) 


bytes 


SRPCOUNT 1 


66 






C 


2 * 


R 


) 




C 5 * C ) 


IRPCOUNT 1 


( 8 


* 


R 


) 




C 


8 


* 


c 


) 


LRPCOUNT | 


C 7 


* 


R 


) 


+ 


C 


2 




C 


) 


SCSCONNCNT 1 


C 2 




R 


) 


+ 


C 










SCSBUFFCNT 1 


2 + 


( 


2 


* C 


) 











Table 1 - Controller / Pesponder Node 



C = maximum number of controllers In tne cluster. 

R = maximum number of resoonders in the cluster. 

+ add 

* multiply 
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Parameter 


Value to add to existing parameter 


NPAGEDYN 


5k + ( 2.5k * C ) bytes 


SRPCOUNT 


66 + R + ( 5 * C ) 


IRPCOUNT 


( 4 * R ) + C 8 * C ) 


LRPCOUNT 


C 2 * R J + ( 2 * C ) 


SCSCONMCNT 


R + C 


SCSBUFFCWT 


2 * C 



Table 2 - Resronder Only Node 



C = maximum number of controllers in the cluster, 
R s maximum number of resoonders in the cluster, 
t add 

* multiply 
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Example - 

Suppose one controller node Is being run In a three node cluster, with 
all three nodes being selected for test. Then, the following 
increases should be made to the sysoen parameters: 

C = 1 
R a 2 

In the controller/responder node: 



The following increases should be made to the sysgen parameters in the 
two resoonder nodes: 



SCSCONNCNT 
SCSBUFFCNT 



NPAGEDYN 
SRPCOUNT 
IRPCOUNT 
LRPCOUNT 



29k + (2.5 * 1) s 3l.5k bytes 
66 + (2 * 2) + (5 * 1) * 75 
(8 * 2) + (9 * 1) = 24 
(7 * 2) + C2 * 1) = 16 
(2 * 2) + 1 a 5 
2 + (2 * 1) = 4 



NPAGEDYN 
SRPCOUNT 
IRPCOUNT 
LRPCOUNT 



5k + (2.5 * 1) = 7.5k bytes 



SCSCONNCNT 
SCSBUFFCNT 



(1 * 2) + (5 * 1) a 7 

(4 * 2) + (8 * 1) = 16 

(2 * 2) ♦ (2 * 1) = 6 
2-1-1 = 3 



C2 * 1) = 2 



APPENDIX B 
PROCESS QUOTAS AND PRIVILEGES 



The following is a table of minimum and tyoical process quotas and 
Drivileqes needed to run the CI exerciser. These values can be 
modified by running the Authorize program. Authorize has a help 
facility to aid in making any necessary changes. 



prio: 


4 


BYTLM: 65000 


BIOLM ! 


1000 


PRCLM : 


2 


pbytlm: o 


DIOLM : 


1000 


ASTLM : 


10 


wSDEFAULTl 150 


FILLM : 


20 


FNQLM : 


20 


WSQUOTA: 1024 


SHRFILLM : 





TQELM : 


100 


wSEXTENT: 1024 


CPUl no 


limit 



Privileges 



CMKRNl , DIAGNOSE ,L0<3.IO, PS WAPM , PHY. IO 



